IBM Books

AIS V3.4 Protocol Reference V1


Configuring and Monitoring IPX

This chapter describes how to configure the IPX protocol and use the IPX monitoring commands. It includes the following sections:


Accessing the IPX Configuration Environment

To access the IPX configuration environment, enter the following command at the Config> prompt:

   Config> protocol IPX
   IPX Protocol user configuration
   IPX Config>

IPX Configuration Commands

This section discusses the IPX configuration commands. Table 39 lists the IPX configuration commands. These commands specify the network parameters for routers transmitting IPX packets. These commands are entered at the IPX config> prompt. To activate the configuration changes, restart the router.

Table 39. IPX Configuration Commands Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Add   Adds an IPX broadcast or IPXWAN point-to-point circuit, adds global IPX filters (access controls), global SAP filters, static routes or services. 
 Delete   Deletes an IPX broadcast or IPXWAN point-to-point circuit, deletes global IPX filters (access controls), global SAP filters, static routes, or services. 
 Disable/Enable  Disables or enables IPX globally or on specific IPX circuits, globally disables or enables the use of IPX static routes or services. Disables or enables Keepalive filtering, RIP-SAP broadcast pacing, SAP reply to get nearest server, NetBIOS broadcasts, and disables or enables RIP or SAP on specific circuits.
 Filter-lists   Accesses the IPX circuit-filter configuration. This environment is where the IPX circuit-based ROUTER, RIP, SAP, and IPX filters are configured. 
 Frame 
 List   Displays the current IPX configuration. 
 Move   Reorders the global IPX filter items (access control), or moves an IPX circuit from one interface to another. 
 Set   Sets the host number, IPXWAN router name and node ID, IPXWAN routing type, connection timeout and retry timer, IPX network numbers, maximum RIP and SAP table sizes, local and remote cache sizes, global IPX filter (access controls) and global SAP filter states, cache sizes, RIP and SAP update intervals,  RIP circuit cost (RIP ticks), Keepalive filtering table size, and split-horizon usage.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add a global IPX filter (access controls), an IPX broadcast circuit, a global SAP filter, an IPX point-to-point circuit, or a static route or service to your IPX configuration.

Syntax:

add
access-control . . .
broadcast-circuit . . .
filter . . .
ipxwan-circuit . . .
route-static . . .
sap-static . . .

access-control type dest-net dest-host dest-socket-range src-net src-host src-socket-range
Determines whether to pass a packet at the IPX level. IPX access controls provide a global access control function at the IPX packet level for the IPX protocol. The access control list is an ordered set of entries that the router uses to filter packets. Each entry can be either Inclusive or Exclusive. Each entry has source and destination network numbers, host addresses, and socket ranges.

When a packet is received from a network for the IPX protocol, and access control is enabled, it is checked against the access control list. It is compared with the net/address/socket pairs in the list until there is a match. If there is a match and the entry is of the Inclusive type, reception of the packet (and potential forwarding) proceeds. If the matching entry is of the Exclusive type, the packet is dropped. If there is no match, the packet is also dropped.

After you create an access-control list with the add access-control command, enable the entries with the set access-control on command. Use the move command to change the order of the access-control list.
Note:Access controls apply to all received packets. If you do not enable reception of RIP (socket 453 hexadecimal) or SAP (socket 452 hexadecimal) packets, the IPX forwarder will be nonfunctional.

     add access I 0 0 453 453 0 0 0 FFFF
     add access I 0 0 452 452 0 0 0 FFFF
     Enter type [E] i
     Destination network number (in hex) [0]? 0
     Destination host (in hex) [ ]? 0
     Starting destination socket number in hex [0]? 452
     Ending destination socket number in hex [0]? 453
     Source network number (in hex) [0]? 0
     Source host number (in hex) [ ]? 0
     Starting source socket number in hex [0]? 0
     Ending source socket number in hex [452]? FFFF

Type
Identifies whether packets are sent or dropped for a specific address or set of addresses. Enter I for include. This causes the router to receive the packet and to forward it if it matches criteria in the remaining arguments. Enter E for exclude. This causes the router to discard the packets.

Dest-net
Network number of the destination. Enter the network number in hexadecimal.

Valid Values: X'00000000' to X'FFFFFFFF'

Zero (0) specifies all networks.

Default Value: 0

Dest-host
Host number on the destination network. Enter the host number in hexadecimal.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Zero (0) specifies all hosts on the network.

Default Value: None

Dest-socket-range
Two numbers that specify an inclusive range of destination sockets. The destination socket value is used for filtering IPX packets.

Valid Values: X'0000' to X'FFFF'

Default Value: 0

Src-net
Network number of the source. Enter the network number in hexadecimal.

This parameter defines the network number of the source IPX network whose packets are filtered by this router.

If you choose to filter on only the source network value, the filter applies to all source sockets, source networks, packet types, and number of hops.

Valid Values: X'00000000' to X'FFFFFFFF'

Zero (0) specifies all networks.

Default Value: 0

Src-host
Host number on the source network. Enter the host number in hexadecimal.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Zero (0) specifies all hosts on the network.

Default Value: None

Src-socket-range
Two numbers that specify an inclusive range of source sockets.

Valid Values: X'0000' to X'FFFF'

Default Value: 0

Note:It is not necessary to use access controls and SAP filters for IPX to work in a NetWare environment. Use them only if necessary.

Example: add access-control E 201 1 451 451 329 0 0 FFFF

This access control prevents all nodes on network 329 from accessing the file server with internal network number 201.

broadcast-circuit interface# ipx-circuit# network#
Adds an IPX broadcast circuit.

interface#
Specifies the network interface on which the IPX circuit number is configured.

Valid Values: valid network interface number

Default: 0

ipx-circuit#
Specifies the IPX circuit number. This number must be unique among all configured IPX circuits in the router and is used to reference IPX circuits in many of the configuration commands.

Valid Values: 1- 65535

Default: next available IPX circuit number

network#
Specifies the IPX network number to be used on the IPX circuit. IPX network number 0 is valid only on IPXWAN unnumbered RIP or static routing circuits. IPX network number FFFFFFFF is not a valid IPX network number. IPX network number FFFFFFFE is reserved for the IPX Default Route and may not be used as an IPX network number.

Valid Values: 1 - FFFFFFFD

Default: 1

Example:

add broadcast-circuit                                           
Which interface [0]?                                  
IPX circuit number [1]?                               
IPX network number in hex                                       
(0 is allowed only on IPXWAN unnumbered circuits) [1]? 400

filter hops service-type service-name
Prevents NetWare bindery overflows for users on large networks by enabling you to determine the number of hops reasonable for a given service. IPX SAP filters allow the protocol to be configured to ignore certain entries in SAP advertisements. This is done to limit the size of the SAP database. This could be necessary due to size limitations in older versions of NetWare file servers. This could also be necessary to limit the amount of SAP data sent across WAN links.

The SAP filters are a global ordered list of filter entries. Each filter entry has a maximum hop count, a service type, and an optional service name. When a SAP response packet is received, each SAP entry is compared with the filter list. If the SAP entry matches an entry in the filter list and is greater than the specified hops, it is ignored and not entered into the local SAP database. If the SAP entry matches an entry in the filter list, and is less than or equal to the specified hops, it is accepted and entered into the local SAP database. If there is no match, the SAP entry is accepted. The arguments for this command are as follows:

Hops
Maximum number of hops permitted for the service.

Valid Values: An integer in the range of 0 to 16.

Default Value: 1

Service-type
Numeric service class.

Valid Values: A hexadecimal value in the range of X'0000' to X'FFFF'.

Use a value of X'0000' to filter all service types.

Default Value: 4

You can see a list of service types by entering the slist command at the IPX> prompt.

Service-name
Identifies the name of the server. In general, this field is not entered.

Valid Values: A string of 1 to 47 ASCII characters (X'20' through X'7E').

Default Value: none

Example: add filter 2 039B NOTES-CHICAGO

This example ignores all SAP advertisements for the Lotus Notes server "NOTES-CHICAGO" at more than 2 hops.

ipxwan-circuit interface# ipx-circuit# network# [use-PVC] [FR-circ#]
Adds an IPXWAN point-to-point circuit.

interface#
Specifies an existing PPP or Frame Relay interface on which the IPX circuit should be configured.

Valid Values: valid network interface number

Default: 0

ipx-circuit#
Specifies the IPX circuit number. This number must be unique among all configured IPX circuits in the router and is used to reference IPX circuits in many of the configuration commands.

Valid Values: 1- 65535

Default: next available IPX circuit number

network#
Specifies the IPX network number to be used on the IPX circuit. IPX network number 0 is valid only on IPXWAN unnumbered RIP or static routing circuits. IPX network number FFFFFFFF is not a valid IPX network number. IPX network number FFFFFFFE is reserved for the IPX Default Route and may not be used as an IPX network number.

Valid Values: 0 - FFFFFFFD

Default: 1

use-PVC
This parameter is only required if the IPXWAN circuit is being configured on a Frame Relay interface. Specifies whether the IPXWAN circuit is being configured on a Frame Relay PVC or SVC. 'Yes' means the IPXWAN circuit is being configured on a PVC. 'No' means the IPX circuit is being configured on an SVC.

Valid Values: Yes or No

Default: Yes

FR-circ#
This parameter is only required if the circuit is being configured on Frame Relay. If the IPXWAN circuit being configured is a Frame Relay PVC, then the parameter specifies the Frame Relay PVC circuit number. If the IPXWAN circuit being configured is a Frame Relay SVC, then the parameter specifies the Frame Relay SVC circuit name.

Valid Values: a valid Frame Relay PVC circuit number or Frame Relay SVC circuit name

Default: 16 (PVC) or None (SVC)

Example:

add ipxwan-circuit                                              
Which interface [0]? 2                                  
IPX circuit number [1]? 3                               
IPX network number in hex                                       
(0 is allowed only on IPXWAN unnumbered circuits) [0]? 412
Use Frame Relay PVC ? yes                                                             
Frame Relay PVC circuit number [16]?
 
add ipxwan circuit
Which interface [0]? 3
IPX circuit number [2]? 4
IPX network number in hex
(0 is allowed only on IPXWAN unnumbered circuits) [0]? 413
Use Frame Relay PVC ? No
Frame Relay SVC circuit name ? Indianapolis                  

route-static dest-net ipx-circuit# nextHop ticks hops
Adds a static route.

dest-net
Specifies the destination IPX network number.

Valid Values: X'1' to X'FFFFFFFE'

Default Value : 1

ipx-circuit#
Specifies an existing IPX circuit on which the static route should be configured.

Valid Values: existing IPX circuit number

Default Value: 1

nextHop
Specifies the IPX host number of the next-hop router through which the destination network can be reached.

Valid Values: X'1' to X'FFFFFFFFFFFE'

Default Value: none

ticks
Indicates the number of ticks between the destination network and this router. The number of ticks represents the amount of time it takes to transmit a 576-byte IPX packet from this router to the destination network. Each tick is 55 milliseconds.

Valid Values: 0 to 30000

Default Value: 0

hops
Indicates the number of hops between the destination network and this router.

Valid Values: 0 to 14

Default Value: 0

Example:

add route-static                                      
IPX net address: (1-fffffffe) [1]? 30       
IPX circuit number [1]? 2                   
IPX node address (in hex) []? 020000002030  
Ticks: (0-3000) [0]? 4                      
Hops: (0-14) [0]? 4                         

sap-static serviceType serviceName ipx-circuit# serverNet serverNode serverSocket hops
Adds a static SAP service.

serviceType
Specifies the hexadecimal service class of the service.

Valid Values: X'0' to X'FFFF'

Default Value: 4

serviceName
Specifies the ASCII name of the service.

Valid Values: up to 47 of the following ASCII characters: 'A'-'Z', 'a'-'z', '0'-'9', '_', '-', '@'.

Default Value: None

ipx-circuit#
Specifies an existing IPX circuit on which the SAP static service should be configured.

Valid Values: existing IPX circuit number

Default Value: 1

serverNet
Specifies the internal IPX network number or home IPX network number of the server.

Valid Values: X'1' to X'FFFFFFFE'

Default Value: 1

serverNode
Specifies the IPX node of the server.

Valid Values: X'1' to X'FFFFFFFFFFFE'

Default Value: None

serverSocket
Specifies the socket number of the server.

Valid Values: X'0' to X'FFFF'

Default Value: 451

hops
Indicates the number of hops between the server and this router.

Valid Values: 0 to 14

Default Value: 0

Example:
add sap-static
Sap type: (0-ffff) [4]? 4
IPX circuit number [1]? 2 
IPX net address: (1-fffffffe) [1]? 40
IPX node address, in hex:  []? 000000000001
IPX socket:  (0-ffff) [451]?
Hops: (0-14) [0] 4    

Delete

Use the delete command to delete an IPX broadcast or IPXWAN point-to-point circuit, a global IPX filter (access control), a global SAP filter, a static route or a static service.

Syntax:

delete
access-control . . .
circuit . . .
filter . . .
route-static . . .
sap-static . . .

access-control line#
Deletes the access control that matches the line number you enter. Enter the list command to display the current line numbers.

Example: delete access-control 2

circuit ipx-circuit#
Deletes the IPX broadcast or IPXWAN point-to-point circuit. It will also delete all of the static routes, static services and circuit filters that are associated with the specified ipx-circuit#.

Example: delete circuit

IPX circuit number [1]? 2
You are about to delete IPX broadcast circuit 2 on interface 4.
All associated static routes, static services and circuit filters
will be deleted as well.  Are you sure? [Yes]: yes

filter hops service-type service-name
Deletes the specified SAP filter. You must type the SAP filter exactly as it appears when you run the list command. The arguments are as follows:

Hops
Maximum number of hops permitted for the service.

Valid Values: 0 to 16

Default Value: 16

Service-type
Numeric service class. Enter a 2-byte hexadecimal number.

Valid Values: X'0000' to X'FFFF'

Default Value: None

Service-name
If the entry you are deleting has a name, specify the name.

Valid Values: A string of 1 to 47 ASCII characters (X'20' through X'7E').

Default Value: None

Example: delete filter 2 039B NOTES-CHICAGO

route-static dest-net ipx-circuit# nextHop
Deletes a static route.

dest-net
Specifies the destination IPX network number.

Valid Values: X'1' to X'FFFFFFFE'

Default Value: 1

ipx-circuit#
Specifies the IPX circuit on which the static route is configured.

Valid Values: existing IPX circuit number

Default Value: 1

nextHop
Specifies the IPX host number of the next-hop router through which the destination network can be reached.

Valid Values: X'1' to X'FFFFFFFFFFFE'

Default Value: none

Example:

delete route-static                                  
IPX net address: (1-fffffffe) [1]? 30      
IPX circuit number [1]? 2                  
IPX node address (in hex) []? 020000002030 

sap-static serviceType serviceName ipx-circuit#
Deletes a static SAP service.

serviceType
Specifies the hexadecimal service class of the service.

Valid Values: X'0' to X'FFFF'

Default Value: 4

serviceName
Specifies the ASCII name of the service.

Valid Values: up to 47 of the following ASCII characters: 'A'-'Z', 'a'-'z', '0'-'9', '_', '-', '@'.

Default Value: None

ipx-circuit#
Specifies the IPX circuit on which the SAP static service is configured.

Valid Values: existing ipx-circuit number

Default Value: 1

Example:

delete sap-static                         
Sap type: (0-ffff) [4]?         
Sap name: (0-ffff) []? filesrv1 
IPX circuit number [1]? 2       

Disable

Use the disable command to disable globally or on specific IPX circuits, globally disables the use of IPX static routes and services. Also, use the disable command to disable replies to SAP to get-nearest-server , RIP-SAP Broadcast Pacing, RIP, or SAP on specific circuits.

Syntax:

disable
circuit . . .
ipx
keepalive-filtering . . .
nebios-broadcast . . .
reply-to-get-nearest-server . . .
rip . . .
rip-sap-pacing . . .
route-static . . .
sap . . .
sap-static . . .

circuit ipx-circuit#
Disables the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit.

Example: disable circuit

IPX circuit number [1]? 2 

ipx
Globally disables the IPX protocol.

Example: disable ipx

keepalive-filtering ipx-circuit#
Disables Keepalive-filtering on the IPX broadcast circuit or IPXWAN point-to-point circuits specified by ipx-circuit#.

Example: disable keepalive-filtering

IPX circuit number [1]? 2 

netbios-broadcast ipx-circuit#
Disables receiving and sending Novell NetBIOS broadcasts (packet type 20) on the IPX circuit specified by ipx-circuit#. The default is value is enabled. Receiving and sending Novell NetBIOS broadcasts is automatically disabled on IPXWAN static routing circuits, even if it is enabled in the configuration.

Example: disable netbios-broadcast

IPX circuit number [1]? 2 

reply-to-get-nearest-server ipx-circuit#
Prevents the router from responding to SAP get-nearest-server requests on the IPX broadcast circuit or IPXWAN point-to-point circuit specified by ipx-circuit#.
Note:Disabling this feature should be done with great caution. This command should be used only when there are multiple routers (or servers) on an IPX network and it is known that the "best" server is not behind this router.

Example: disable reply-to-get-nearest

IPX circuit number [1]? 2 

rip ipx-circuit#
Disables RIP on the IPX broadcast circuit or IPXWAN point-to-point circuit specified by ipx-circuit#. The default is for RIP to be enabled on all circuits. RIP will automatically be disabled on circuits using IPXWAN Static Routing, even if it is configured as enabled.

Example: disable rip 1

rip-sap-pacing ipx-circuit#
Prevents RIP/SAP Broadcast Pacing on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#. When pacing is disabled, RIP and SAP periodic broadcasts are transmitted on the circuit with a 55 msec interpacket gap (the default setting). Enable pacing only on circuits where RIP and SAP broadcasts might cause congestion (for example, you can enable pacing on frame-relay or X.25 circuits with many virtual circuits).

Example: disable rip-sap-pacing

IPX circuit number [1]? 2 

route-static
Globally disables the use of static routes.

Example: disable route-static

sap ipx-circuit#
Disables SAP on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit. The default is for SAP to be enabled on all circuits. SAP will automatically be disabled on RLAN circuits and on IPXWAN Static Routing, even if SAP is configured as enabled.

Example: disable sap

IPX circuit number [1]? 2

sap-static
Globally disables the use of static services.

Example: disable sap-static

Enable

Use the enable command to enable IPX globally or on specific circuits. The enable command can also be used to globally enable the use of IPX static routes or services, enables keepalive filtering, RIPS-SAP broadcast pacing, SAP reply to get-nearest-server, RIP or SAP on specific circuits.

Syntax:

enable
circuit . . .
ipx
keepalive-filtering . . .
nebios-broadcast . . .
reply-to-get-nearest-server . . .
rip . . .
rip-sap-pacing . . .
route-static . . .
sap . . .
sap-static . . .

circuit ipx-circuit# network#
Enables the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit# and specifies the IPX network number for the IPX circuit. The IPX circuit will be enabled if a valid IPX network number is configured.

Example: enable circuit

IPX circuit number [1]?                               
IPX network number in hex                                       
(0 is allowed only on IPXWAN unnumbered circuits) [1]?

ipx-circuit#
Specifies the IPX broadcast or IPXWAN point-to-point circuit to be enabled.

Valid Values: any valid ipx-circuit number

Default Value: 0

network#
Specifies the IPX network to be used on the circuit. IPX network number 0 is valid only on IPXWAN unnumbered RIP or static routing circuits. IPX network number FFFFFFFF is not a valid IPX network number. IPX network number FFFFFFFE is reserved for the IPX Default Route and may not be used as an IPX network number.

Valid Values: X'0' to X'FFFFFFFD'

Default Value: 1

Example:

ipx
Globally enables the IPX protocol.

Example: enable ipx

keepalive-filtering ipx-circuit#
Enables Keepalive filtering on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#.

Example: enable keepalive-filtering

IPX circuit number [1]? 2 

netbios-broadcast ipx-circuit#
Enables receiving and sending Novell NetBIOS broadcasts (packet type 20) on the IPX circuit specified by ipx-circuit#. The default value is enabled. Receiving and sending Novell NetBIOS broadcast is automatically disabled on IPXWAN static routing circuits, even if enabled in the configuration.

Example: enable netbios-broadcast

IPX circuit number [1]? 2 

reply-to-get-nearest-server ipx-circuit#
Enables the router to respond to SAP get-nearest-server requests on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#.

Example: enable reply-to-get-nearest

IPX circuit number [1]? 2 

rip ipx-circuit#
Enables RIP on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#. The default is for RIP to be enabled on all IPX circuits. RIP is automatically disabled on RLAN circuits and on IPXWAN static routing circuits, even if RIP is enabled in the configuration.

Example: enable rip

IPX circuit number [1]? 2 

rip-sap-pacing ipx-circuit#
Enables RIP/SAP Broadcast Pacing on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#.
Note:The router calculates an interpacket gap that guarantees that broadcast completion within the configured RIP and SAP update intervals. Configuring these intervals to a larger value may be necessary for the router to calculate a sufficiently large interpacket gap.

Pacing should be enabled only on circuits where RIP and SAP broadcasts might cause congestion (for example, on frame-relay or X.25 circuits with many virtual circuits).

Example: enable rip-sap-pacing

IPX circuit number [1]? 2 

route-static
Globally enables the use of static routes.

Example: enable route-static

sap ipx-circuit#
Enables SAP on the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#.

Example: enable sap

sap-static
Globally enables the use of static services.

Example: enable sap-static

Filter-lists

Use the filter-lists command to access the IPX filter-type-List Config> prompt. Valid filter list types are router, rip, sap, and ipx.

For information about the commands available at the IPX filter-type.-List Config> prompt, see "IPX Circuit-Filter Configuration Commands".

Syntax:

filter-lists
router-lists
rip-lists
sap-lists
ipx-lists

Example: filter-lists router-lists

Frame

Use the frame command to specify the packet format for IPX circuits. (Encapsulation can also be set using the CONFIG network command.)
Note:When there are incorrect or invalid configuration records, the default frame values are used.

Syntax:

frame
ethernet_II . . .
ethernet_8022 . . .
ethernet_8023 . . .
ethernet_SNAP . . .
token-ring MSB . . .
token-ring LSB . . .
token-ring_SNAP MSB . . .
token-ring_SNAP LSB . . .

ethernet_II ipx-circuit#
Sets the frame type to ethernet_II on the IPX broadcast circuit specified by ipx-circuit#. The ethernet_II encapsulation uses ethernet version 2.0 with protocol type 8137. This is the NetWare 4.0 and greater default.

Example: frame ethernet_II

IPX circuit number [1]? 

ethernet_8022 ipx-circuit#
Sets the frame type to ethernet_8022 on the IPX broadcast circuit specified by ipx-circuit#. The ethernet_8022 encapsulation uses LLC encapsulation with SAP E0.

Example: frame ethernet_8022

IPX circuit number [1]? 

ethernet_8023 ipx-circuit#
Sets the frame type to ethernet_8023 on the IPX broadcast circuit specified by ipx-circuit#. The ethernet_8023 encapsulation uses ethernet 802.3 encapsulation with no LLC header. This is the pre-NetWare 4.0 default. It is also the router default.

Example: frame ethernet_8023

IPX circuit number [1]? 

ethernet_SNAP ipx-circuit#
Sets the frame type to ethernet_SNAP on the IPX broadcast circuit specified by ipx-circuit#. The ethernet_SNAP encapsulation uses SNAP encapsulation with a PID of 0000008137.

Example: frame ethernet_SNAP

IPX circuit number [1]? 

token-ring MSB ipx-circuit#
Sets the frame type to token-ring MSB on the IPX broadcast circuit specified by ipx-circuit#. The token-ring MSB encapsulation uses LLC encapsulation with SAP E0, and uses noncanonical MAC addresses. This is the NetWare default. It is also the router default.

Example: frame token-ring MSB

IPX circuit number [1]? 

token-ring LSB ipx-circuit#
Sets the frame type to token-ring LSB on the IPX broadcast circuit specified by ipx-circuit#. The token-ring LSB encapsulation uses LLC encapsulation with SAP E0, and uses noncanonical MAC addresses.

Example: frame token-ring LSB

IPX circuit number [1]? 

token-ring_SNAP MSB ipx-circuit#
Sets the frame type to token-ring_SNAP MSB on the IPX broadcast circuit specified by ipx-circuit#. The token-ring_SNAP MSB encapsulation uses SNAP encapsulation with PID 0000008137, and uses canonical MAC addresses.

Example: frame token-ring_SNAP MSB

IPX circuit number [1]? 

token-ring_SNAP LSB ipx-circuit#
Sets the frame type to token-ring LSB on the IPX broadcast circuit specified by ipx-circuit#. The token-ring LSB encapsulation uses SNAP encapsulation with PID 0000008137 and uses noncanonical MAC addresses.

List

Use the list command to display the current IPX configuration.

Syntax:

list
access-controls
all
circuit
filters
route-static
sap-static
summary

access-controls
Lists the global IPX filters (access-controls). This command displays the information that is displayed in the "Access Control Configuration" section of the list all.

all
Lists the entire IPX configuration.

Example:

 list all
 
IPX Globals
------------                                                          
IPX Globally                Enabled                                   
Host Number (serial line)   020000003024                              
Maximum Services                  32                                  
Maximum Networks                  32                                  
Maximum Routes                    32                                  
Maximum Routes per Destination    1                                   
Maximum Local Cache entries       64                                  
Maximum Remote Cache entries      64                                  
Keepalive-Filtering Table Size    32                                  
                                                                      
 
IPX Configuration:                                                   
 
------------------                                                    
                                  NetBIOS    Keepalive                
Circ   Ifc    NetNum    IPX       Broadcast  Filtering  Encapsulation 
 1      0      400       Enabled   Enabled    Disabled   ETHERNET_II   
 2      1      411       Enabled   Enabled    Disabled   N/A           
 3      2      412       Enabled   Enabled    Disabled   N/A           
        Frame Relay PVC circuit number: 16
 4      3      413       Enabled   Enabled    Disabled   N/A
        Frame Relay SVC circuit name: Indianapolis
   
 
 
RIP Configuration:                                                        
------------------                                                        
                                  Update    Split      Broadcast  RIP         
Circ   Ifc    NetNum    RIP       Interval  Horizon    Pacing     Ticks              
1      0      400       Enabled   1         Enabled    Disabled   0           
2      1      411       Enabled   1         Enabled    Disabled   3           
3      2      412       Enabled   1         Enabled    Disabled   0            
4      3      413       Enabled   1         Enabled    Disabled   0           
                                                                          
 
 
 
SAP Configuration:                                                        
------------------                                                        
                                  Update    Split      Broadcast  Get Nearest
Circ   Ifc    NetNum    SAP       Interval  Horizon    Pacing     Reply   
1      0      400       Enabled   1         Enabled    Disabled   Enabled 
2      1      411       Enabled   1         Enabled    Disabled   Enabled 
3      2      412       Enabled   1         Enabled    Disabled   Enabled 
4      3      413       Enabled   1         Enabled    Disabled   Enabled 
 
 
 
IPXWAN Configuration:                                                     
---------------------
Router Name    ipxwan-413                                                
NodeID         413                                                       
                        Routing  Connect     Retry                       
Circ   Ifc    NetNum    Type     Time (sec)  Time (sec)                  
2      1      411       RIP      60          60                          
3      2      412       RIP      60          60                          
4      3      413       RIP      60          60               
        
Static Route Configuration:                                              
---------------------------                                              
Static Routes:  Enabled                                                  
Dest Net  Hops   Ticks  Next Hop      Circ   Ifc                         
ABC       3      4      020000003044  3      2                           
                                                                         
Static Services Configuration:                                           
------------------------------                                           
Static Services:  Enabled                                                
Type Service Name                   Srv Net  Host         Sock Hops Circ   Ifc
4    FILESRV01                      ABC      000000000001 451  3    3      2
                                                                        
SAP Filter Configuration:                                              
-------------------------                                              
IPX SAP Filters:  Enabled                                              
Index Max Hops  Type  Service Name                                     
1     5         4     FILESRV02                                        
                                                                       
Access Control Configuration:                                          
-----------------------------                                          
IPX Access Controls:  Enabled                                          
#   T Dest Net Host         Sock Sock Src Net  Host         Sock Sock  
1   E 2        000000000000 0    FFFF 3        000000000000 0    FFFF  
2   I 0        000000000000 452  453  0        000000000000 0    FFFF

circuit ipx-circuit#
Lists the IPX broadcast or IPXWAN point-to-point circuit specified by ipx-circuit#. This command displays the information shown in the "IPX Configuration," "RIP Configuration," "SAP Configuration," and "IPXWAN Configuration" sections of the list all command example.

filters
Lists the global SAP filters. This command displays the information shown in the "SAP Filter Configuration" section of the list all command example.

route-static
Lists the static routes. This command displays the information shown in the "Static Route Configuration" section of the list all command example.

sap-static
Lists the static services. This command displays the information shown in the "Static Services Configuration" section of the list all command example.

summary
Lists a summary of the IPX, RIP, SAP, IPXWAN, and Keepalive filtering configuration for all circuits on which IPX is enabled. This command displays the information shown in the "IPX Globals," "IPX Configuration," "RIP Configuration," "SAP Configuration," and "IPXWAN Configuration" sections of the list all command example.

IPX Globals
The following global information is displayed:

IPX Configuration
The following is displayed for each circuit on which IPX is enabled:

PVC circuit number
Displays the number of the Frame Relay PVC circuit.

SVC circuit name
Displays the name of the Frame Relay SVC circuit.

RIP Configuration
The following information is displayed for each circuit on which IPX is enabled:

SAP Configuration
The following information is displayed for each circuit on which IPX is enabled:

IPXWAN Configuration
The following global information is displayed: The following information is displayed for each IPXWAN circuit :

Static Routes Configuration
Displays whether static routes are globally enabled or disabled. In addition, the following is displayed for each configured static route.

Static Services Configuration
Displays whether static services are globally enabled or disabled. In addition, the following is displayed for each configured static service:

SAP Filter Configuration
Displays whether the global SAP filters are enabled or disabled. In addition, the following information is displayed for each configured global SAP filter:

Access Control Configuration
Displays whether the global IPX filters (access controls) are enabled or disabled. In addition, the following information is displayed for each configured global IPX filter (access control):

Move

Use the move command to reorder the global IPX filter items (access control), or move an IPX circuit from one interface to another.

Syntax:

move
access-control srcLine# dstLine#
circuit ipx-circuit# interface# [use-PVC] ]FR-circ#]

access-control srcLine# dstLine#

srcLine#
Specifies the line number of the access control you want to move.

dstLine#
Specifies the line number of the access control after which the scrLine should be moved.

After the line is access control is moved, the lines are renumbered.

Example:

move access-control
Enter index of control to move [1]? 1                       
Move record AFTER record number [0]? 2                      
About to move:                                                        
#   T Dest Net Host         Sock Sock Src Net  Host         Sock Sock 
1   E 2        000000000000 0    FFFF 3        000000000000 0    FFFF 
to be after:                                                          
2   I 0        000000000000 452  453  0        000000000000 0    FFFF 
Are you sure this is what you want to do? [Yes]: yes        

circuit ipx-circuit# interface# [use-PVC FR-circ#]
Moves an IPX circuit from one network interface to another. This command also moves all of the static routes, static services, and IPX circuit filters associated with the given ipx-circuit# to the same interface#. If an IPXWAN circuit is being moved to a Frame Relay interface, you are prompted to specify whether the new circuit is a Frame Relay PVC or SVC circuit, and to provide the Frame Relay circuit number or circuit name, as appropriate.

ipx-circuit#
Specifies the IPX circuit that is to be moved.

Valid Values: an existing IPX circuit number

Default Value: 1

interface#
Specifies the network interface that the IPX circuit is moving to.

Valid Values: an existing network interface number.

Default Value: 0

use-PVC
Specifies whether the IPXWAN circuit is being moved to a Frame Relay PVC or SVC. 'Yes' means the IPXWAN circuit is being moved to a PVC. 'No' means the IPXWAN circuit is being moved to an SVC. This parameter is only required if the IPXWAN circuit is being moved to a Frame Relay interface.

Valid Values: Yes or No

Default Value: Yes

FR-circ#
Specifies the Frame Relay PVC circuit number or Frame Relay SVC circuit name. This parameter is required only if the IPX circuit is an IPXWAN circuit being moved to a Frame Relay interface.

Valid Values: existing PVC Frame Relay PVC circuit number or Frame Relay SVC circuit name

Default Value: 16 (PVC) or None (SVC)

Example: move circuit

 
IPX circuit number [1]?
Which interface do you want to move the IPX circuit to []? 5
Use Frame Relay PVC? [Yes]:
Frame Relay PVC circuit number [16]? 18
You are about to move IPXWAN circuit 1,
from Frame Relay interface 2 (FR circuit 16) to 
Frame Relay interface 5 (FR circuit 18).
All associated static routes, static services and circuit filters 
will be moved as well. Are you sure? [Yes]: Y
 

Set

Use the set command to configure the host number, IPXWAN router name and node ID, IPXWAN routing type, connection timeout and retry timer, IPX network numbers, maximum RIP and SAP table sizes, local and remote cache sizes, global IPX filter (access control) and global SAP filter states, RIP and SAP update intervals, IPX route cost (in ticks), Keepalive filter table size and split-horizon usage.

Syntax:

set
access-control . . .
filter . . .
host-number . . .
ipxwan . . .
keepalive-table-size . . .
local-cache size . . .
maximum routes-per-destination . . .
maximum networks . . .
maximum services . . .
maximum total-route-entries . . .
name . . .
net-number . . .
node-id . . .
remote-cache size . . .
rip-ticks . . .
rip-update-interval . . .
sap-update-interval . . .
split-horizon . . .

access-control on or off
Turns the global IPX filters (access controls) on or off. Enter on or off.

Example: set access-control on

filter on or off
Turns the global SAP filters on or off. Enter on or off.

Example: set filter on

host-number host#
Specifies the host number used for serial circuits running IPX. Each IPX router operating over serial circuits must have a unique host number. This is required because serial circuits do not have hardware node addresses from which to build a host number. It cannot be a multicast address.
Note:If you configure a mixture of IPX broadcast and IPXWAN circuits on the same interface, it is strongly recommended that you configure the host-number to be the IPXWAN node-id followed by X'0000'.

Valid Values: An 12-digit hexadecimal number in the range of X'000000000001' to X'FEFFFFFFFFFF'.

Default Value: none

This number must be unique on each router.

Example: set host-number 0000000000F4
Note:IPXWAN requires a router node ID and name to be configured. Use the set node-ID and set name commands to configure these parameters.

ipxwan ipx-circuit# routing-type timeout retryTimer
Sets the IPXWAN routing type, connection timeout and retry timer. Before the set ipxwan command can be invoked, you must add an IPXWAN circuit.

ipx-circuit#
Specifies an existing IPXWAN point-to-point circuit on which the parameters will be set.

Valid Values: any existing IPXWAN point-to-point circuit number

Default Value: 1

routingType
Specifies the IPXWAN routing type to be negotiated.
  • u for unnumbered RIP
  • r for number RIP
  • b for both unnumbered and numbered RIP
  • s Static Routing

Valid Values: 'u', 'U', 'r', 'R', 'b', 'B', 's', 'S'

Default Value: 'u'

timeout
This value specifies the time limit, in seconds, within which the IPXWAN negotiation must be successfully completed. If it cannot be successfully completed before the connection timer expires, IPXWAN starts a retry timer. The device will not retry the negotiation until the retry timer expires.

Valid Values: An integer number of seconds in the range of 5 to 300.

Default Value: 60 seconds

retryTimer
This parameter specifies the amount of time to wait after a connection is timed out before trying to reestablish the connection.

Valid Values: An integer number of seconds in the range of 5 to 600.

Default Value: 60 seconds

Example: set ipxwan

IPX circuit number [1]? 3                                       
Routing type ('u'=Unnumbered, 'r'=RIP, 'b'=Both, 's'=Static) [u]                                                                          
Connection Timeout (in sec) [60]?                               
Retry timer (in sec) [60]?                                      
 

keepalive-table-size value
Sets the number of entries that the Keepalive table holds. These entries include all current client/server and server/server pairs connected over the WAN link.

Valid Values: 1 to 250

Default: 32

Example: set keepalive-table-size

Number of entries [32]?

local-cache size size
Specifies the size of the local cache routing table.

The size of the local cache should equal the total number of clients on each router's local or client network plus a 10% buffer to prevent excessive purge requests.

Valid Values: The range is 1 to 10000.

Default Value: 64. For more information, see "Local Cache" and "Remote Cache".

Example: set local-cache size

New IPX local node cache size [64]? 80

maximum routes-per-destination routes
Specifies the maximum number of routes per destination network to store in the IPX RIP routes table.

Valid Values: An integer in the range of 1 to 64.

Default Value: 1. For additional information on multiple routes, see "Configuring Multiple Routes".

Example: set maximum routes-per-destination 8

maximum networks size
Specifies the size of the IPX RIP network table. This reflects the number of networks in the internet on which IPX operates.

Valid Values: 1 to 2048

Router memory constraints can prevent the maximum table size from being used.

Default Value: 32 This value cannot be larger than the maximum total-route-entries size.

Example: set maximum networks 30

maximum services size
Specifies the size of the IPX SAP service table. This reflects the number of SAP services in the internetwork on which IPX operates.

Valid Values: 1 to 2048

Router memory constraints can prevent the maximum table size from being used.

Default Value: 32

Example: set maximum services 30

maximum total-route-entries size
Specifies the size of the IPX RIP routes table. This reflects the total number of routes, including alternate routes, in the internetwork on which IPX operates.

Valid Values: 1 to 4096

Default Value: 32

This value must be at least as large as the maximum networks size. For additional information of multiple routes, see "Configuring Multiple Routes".

Example: set maximum total-route-entries 40

name router_name
Lets you assign a symbolic name to the router. IPXWAN requires a router to have a node id and name.

Valid Values: A variable length string of 1 to 47 characters.

The router_name can contain the characters A through Z, 0 through 9, underscore (_), hyphen (-), and "at" sign (@).

Default Value: none.

Example: set name newyork_accounting

net-number ipx-circuit# network#
Specifies the IPX network number fro the IPX broadcast or IPXWAN point-to-point circuit.

ipx-circuit#
Specifies an existing IPX broadcast or IPXWAN point-to-point circuit.

Valid Values: an existing circuit number

Default Value: 1

network#
Specifies the IPX network number to be used on the IPX circuit. IPX network number 0 is valid only on IPXWAN unnumbered RIP or static routing circuits. IPX network number FFFFFFFF is not a valid IPX network number. IPX network number FFFFFFFE is reserved for the IPX Default Route and may not be used as an IPX network number. The set command will be ignored if a valid IPX network number is not configured.

Valid Values: X'0' to X'FFFFFFFD'

Default Value: 1

Example: set net-number

IPX circuit number [1]? 2                             
IPX network number in hex                                       
(0 is allowed only on IPXWAN unnumbered circuits) [1]?

node-id network#
Specifies the IPXWAN internal network number. A value of 0, FFFFFFFF or FFFFFFFE is not valid for the internal network number. IPXWAN will not be enabled unless a valid node ID is configured.

Default Value: 1

Example: set node-id 2

remote-cache size size
Specifies the size of the remote cache routing table.

The size of the remote cache should equal the total number of remote networks used by the router plus a 10% buffer to prevent excessive purge requests.

Valid Values: The range is 1 to 10000.

Default Value: 64.

Example: set remote-cache size

New IPX remote network cache size [64]? 80

rip-ticks ipx-circuit# value
Indicates the circuit cost, in ticks, associated with this circuit. The number of ticks represents the amount of time it takes to transmit a 576-byte IPX packet on this IPX circuit. Each tick is 55 milliseconds. A value of 0 indicates that the router will calculate the tick value. A configured non-zero value will override any calculated value, including IPXWAN.

ipx-circuit#
Specifies an existing IPX broadcast to IPXWAN point-to-point circuit.

Valid Values: any valid IPX circuit number

Default: 1

value
Specifies the tick value

Valid Values: The range is 1 to 30000.

Default Value: 0

Example: set rip-ticks

IPX circuit number [1]? 2
RIP ticks value (in 55mec ticks) [0]? 3
 

rip-update-interval ipx-circuit# interval
Specifies the interval in minutes at which RIP periodic broadcasts should occur on a specific IPX circuit.

Increasing the RIP interval reduces traffic on WAN lines and dial circuits. It also prevents dial-on-demand circuit from dialing out so often.

Note:While complete RIP advertisements are controlled by the interval, the router still propagates network topology changes as quickly as it learns about them.

ipx-circuit#
Specifies an existing IPX broadcast to IPXWAN point-to-point circuit.

Valid Values: any valid IPX circuit number

Default: 1

interval
Specifies the interval in minutes

Valid Values: The range is from 1 to 1440 minutes.

Default Value: 1 minute. For additional information on RIP interval, see "Specifying RIP Update Interval".

Example: set rip-update-interval

IPX circuit number [1]? 2                                              
RIP Timer Value (minutes) [1]? 2 

sap-update-interval ipx-circuit# interval
Specifies the time delay in minutes at which SAP periodic broadcasts should occur on a specific IPX circuit.

Increasing the SAP interval reduces traffic on WAN lines and dial circuits. It also prevents dial-on-demand circuit from dialing out so often.
Note:While complete SAP advertisements are controlled by the interval, the router still propagates service changes as quickly as it learns about them.

ipx-circuit#
Specifies an existing IPX broadcast or IPXWAN point-to-point circuit.

Valid Values: any valid IPX number

Default: 1

interval
Specifies the interval in minutes.

Valid Values: The range is from 1 to 1440 minutes.

Default Value: 1 minute.

Example: set sap-update-interval

IPX circuit number [1]? 2                                              
SAP Timer Value (minutes) [1]? 2 

split-horizon heuristic enabled disabled
Specifies the type of split-horizon used on the IPX circuit.

If there is only a single Frame Relay VC on the circuit, split-horizon is enabled; otherwise split-horizon is disabled.

Generally, split-horizon should be set to enabled. It is sometimes necessary to disable split-horizon for partially-meshed broadcast circuits on Frame-Relay, and X.25 configurations. For additional information on split-horizon, see "Split-Horizon Routing".

heuristic
Enables split-horizon on the IPX circuit, except for Frame Relay IPX broadcast circuits.

Valid Values: any valid IPX circuit number

Default: 1

enabled
Enables split-horizon on the IPX circuit.

Valid Values: 1-1440

Default: 1

disabled
Disables split-horizon IPX circuit.

Valid Values: 1-1440

Default: 1

Example: set split-horizon enabled 0

IPX circuit number [1]? 2 

Accessing the IPX Circuit Filter Configuration Environment

To access the IPX circuit filter configuration environment, enter the following command at the IPX config> prompt:

IPX Config> filter-lists type
IPX type-List Config>

Where type is the type of IPX filter to be configured. Valid types are router-lists, rip-lists, sap-lists, and ipx-lists.

When creating a filter, an IPX circuit number is required.


IPX Circuit-Filter Configuration Commands

This section describes the commands used to configure the IPX circuit-based filters; ROUTER, RIP, SAP, and IPX. To configure these filters, enter the filter-lists type command at the IPX Config> prompt, and then enter the configuration commands at the IPX type-List Config> prompt.

Table 40. IPX Filter Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Attach   Attaches a specified filter-list to a specified filter. 
 Create   Creates a filter or filter-list. 
 Default   Sets the default action of a filter to include or exclude 
 Delete   Deletes a filter or filter-list. 
 Detach   Detaches a filter-list from a filter. 
 Disable   Disables filtering. 
 Enable   Enables filtering. 
 List   Displays the current filtering configuration. 
 Move   Reorders filter-lists attached to a filter. 
 Set-cache   Sets the caching size for a specified filter. 
 Update   Accesses the IPX type-List filter-list Config> prompt. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Attach

Use the attach command to attach a filter-list to a filter.

Syntax:

attach list-name
filter#

list-name
Specifies the name of the filter-list. The list command can be used to display a list of the configured filter-list names.

Valid Values: Any alphanumeric string up to 16 characters

Default Value: None

filter#
Specifies the number of the filter. A numbered list of configured filters can be obtained using the list command.
Example: attach test_list 1

Create

Use the create command to create a filter-list or filter.

Syntax:

create
list ...
filter ...

list list-name
Creates a list with the specified name.

Valid Values: Any alphanumeric string up to 16 characters

Default Value: none

You can also enter the create list command with no list name. You will then be prompted for the list name.

Example: create list example_list

filter direction ipx-circuit#
Creates a filter for the specified direction on the specified circuit. Specify input to filter packets received on the specified circuit. Specify output to filter packets to be sent by the specified circuit.

A number is automatically assigned to a filter when it is created and from that point on is used to identify the filter, rather than having to key in the circuit and direction (input or output) for all subsequent commands.

Example: create filter input 1

Default

Use the default command to set the default action for a filter. The default action is taken when no match is found for any of the filter items.

Syntax:

default
action filter#
Example:
default exclude 1

action
Specifies the default action. Include specifies that when no match is found to any of the filter items, the packet is processed. Exclude indicates that when no match is found, the packet is dropped.

filter#
Specifies the number of the filter. Use the list command to display a numbered list of configured filters.

Delete

Use the delete command to delete a filter-list or filter.

Syntax:

delete
list ...
filter ...

list list-name
Deletes the specified list. The list command can be used to display the configured filter list names.

Example: delete list example_list

filter filter#
Deletes the specified filter. The list command can be used to display a numbered list of configured filters.

Example: delete filter 1

Detach

Use the detach command to detach a filter-list from a filter.

Syntax:

detach
list-name filter#

list-name
Specifies the name of the filter-list. The list command can be used to display a list of the configured filter names.

Valid Values: Any alphanumeric string up to 16 characters

Default Value: None

filter#
Specifies the number of the filter. The list command can be used to display a numbered list of configured filters.
Example: detach test_list 1

Disable

Use the disable command to disable filtering globally or for a specified filter.

Syntax:

disable
all
filter ...

all
Disables all filters of the current type (ROUTER, RIP, SAP, or IPX).

Example: disable all

filter filter#
Disables the specified filter. Use the list command to display a numbered list of configured filters.

Example: disable filter 1

Enable

Use the enable command to enable filtering globally or for a specified filter.

Syntax:

enable
all
filter ...

all
Enables all filters of the current type (ROUTER, RIP, SAP, or IPX).

Example: enable all

filter filter#
Enables the specified filter. Use the list command to display a numbered list of configured filters

Example: enable filter 1

List

Use the list command to globally display the state of the current filtering type, or to display information about a specific filter.

Syntax:

list
all
filter ...

all
Lists information about the state of all filters of the current type.

Example: list all

Filtering: ENABLED                                                        
                                                                          
Filter Lists:                                                             
Name                           Action                                     
------------------------------ ----------                                 
ipx01                          EXCLUDE                                    
ipx02                          INCLUDE                                    
ipx03                          EXCLUDE                                    
                                                                          
Filters:                                                                  
Id    Circ  Ifc   Direction  State      Default    Cache                  
----- ----- ----- ---------- ---------- ---------- -----                  
1     3     2     INPUT      ENABLED    INCLUDE       10                  
2     2     1     INPUT      ENABLED    INCLUDE       10                  

filter filter#
Lists information about the specified filter. Use the list command to display a numbered list of configured filters.

Example: list filter 2

Filters:                                                                  
Id    Circ  Ifc   Direction  State      Default    Cache 
----- ----- ----- ---------- ---------- ---------- -----                  
2     2     1     INPUT      ENABLED    INCLUDE       10                  
                                                                          
Filter Lists:                                                             
Name                           Action                                     
------------------------------ ----------                                 
ipx01                          EXCLUDE                                    

Move

Use the move command to change the order of filter lists within a filter. Packets are evaluated against the filter lists in the order the lists occur. The first match stops the filtering process.

Syntax:

move
src-list-name dst-list-name filter#

src-list-name
Specifies the list to be moved within the filter.

dst-list-name
Specifies the list before which the src-list-name will be moved.

filter#
Specifies the filter to which the lists belong. The list command can be used to display a list of the configured filters and their attached filter lists.
Example: move test-list-1 test-list-2 2

Set-cache

Use the set-cache command to set the size of the filter cache. A filter cache is only supported for the IPX circuit filter; the ROUTER, RIP and SAP circuit filters do not support a cache.

Syntax:

set-cache
size filter#

size
Specifies the size of the filter cache (in number of entries).

Valid Values: 4 to 64 cache entries.

Default Value: 10 entries.

filter#
Specifies the number of the filter. The list command can be used to display a numbered list of configured filters.
Example: set-cache 10 1

Update

The update command accesses the IPX type-List list-name Config> prompt. From this prompt you can issue commands to add, delete, or move items within the list being updated. From this prompt you can also set the action for the filter-list being updated.

Syntax:

update
list-name

list-name
Specifies the name of the filter-list. The list command can be used to display the configured filter-list names.
Example: update test-list

Add (Update Subcommand)

Use the add subcommand to add items to a filter-list. The list item parameters vary based on the type of circuit filter (ROUTER, RIP, SAP, or IPX) being configured. For all types of circuit filter, the add command can be entered without parameters. You will then be prompted for the required parameters.

Add (ROUTER)

Syntax:

add
node-number mask

node-number
Specifies the value to be compared against the source node number of the router which sent the RIP response packet (after being ANDed with the mask). If you want to match on a single node, set the node-number parameter to the address and set the mask to FFFFFFFFFFFF. If you want to match on all nodes, set the node-number parameter and the mask parameter to 000000000000.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Default Value: none

mask
Specifies the value to be ANDed with the source node address of the router which sent the RIP response packet (before being compared with the address parameter).

If you want to match on a single address, set the address parameter to the address and set the mask to FFFFFFFFFFFF. If you want to match on all addresses, set the address parameter and the mask parameter to 000000000000.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Default Value: X'FFFFFFFFFFFF'

Example: add 400000001000 ffffffff0000

Add (RIP)

Syntax:

add
net-range-start net-range-end

net-range-start
Specifies the start of a range (inclusive) of IPX network numbers to be filtered. If you want to match on a single network number, set the net-range-start and net-range-end parameters to that network number. If you want to match on all network numbers, set the net-range-start to X'00000001' and the net-range-end to X'FFFFFFFE'.

Valid Values: X'1' to X'FFFFFFFE'

Default Value: X'1'

net-range-end
Specifies the end of a range (inclusive) of IPX network numbers to be filtered.

Valid Values: X'1' to X'FFFFFFFE'

Default Value: X'1'

Example: add 00000001 FFFFFFFE

Add (SAP)

Syntax:

add
comparitor hops sap-type name

comparitor
Specifies the type of hop count comparitor for this list item.

Valid Values:

<

<=

=

>=

>

Default Value: <= The comparitor and hops parameters are ignored on output filters.

hops
Specifies the hop count for this list item. If you do not want to filter based on hop count, enter <= 16 for the comparitor and hop count. The comparitor and hops parameters are ignored on output filters.

Valid Values: 0 to 16

Default Value: 16

sap-type
Specifies the service type to be filtered. Enter the service type, or X'0000' for all service types.

Valid Values: X'0' to X'FFFF'

Default Value: 4

name
Specifies the service name to be filtered.

Valid Values:

A string of 1 to 47 ASCII characters (X'20' through X'7E').

The question mark (?) and asterisk (*) characters serve as wildcard characters. The question mark may be used multiple times to represent any single character within the server name. The asterisk may be used multiple times to represent any portion of the server name. The question mark and asterisk may also be used together.

Default Value: none

Example: add < 6 0004 *

Add (IPX)

Syntax:

add
comparitor hops ipx-type dst-net-range-start dst-net-range-end dst-node dst-mask dst-sck-range-start dst-sck-range-end src-net-range-start src-net-range-end src-node src-mask src-sck-range-start src-sck-range-end

comparitor
Specifies the type of hop count comparitor for this list item. The comparitor and hops parameters are ignored on output filters.

Valid Values:

Default Value: <=

hops
Specifies the hop count for this list item. If you do not want to filter based on hop count, enter <= 16 for the comparitor and hop count. The comparitor and hops parameters are ignored on output filters.

ipx-type
Specifies the IPX packet type to be filtered. Enter the packet type, or 00 for all packet types.

Valid Values: X'0' to X'FF'

Default Value: X'0'

dst-net-range-start
Specifies the start of a range (inclusive) of destination IPX network numbers to be filtered. If you want to match on a single network number, set the dst-net-range-start and dst-net-range-end parameters to that network number. If you want to match on all network numbers, set the dst-net-range-start to X'00000001' and the dst-net-range-end to X'FFFFFFFE'.

Valid Values: X'00000000' to X'FFFFFFFF'

Default Value: X'00000000'

dst-net-range-end
Specifies the end of a range (inclusive) of destination IPX network numbers to be filtered. If you want to match on a single network number, set the dst-net-range-start and dst-net-range-end parameters to that network number. If you want to match on all network numbers, set the dst-net-range-start to X'00000001' and the dst-net-range-end to X'FFFFFFFE'.

Valid Values: X'00000000' to X'FFFFFFFF'

Default Value: X'00000000'

dst-node
Specifies the value to be compared against the destination node number (after being ANDed with the dst-mask). If you want to match on a single node, set the dst-node parameter to the node number and set the dst-mask to X'FFFFFFFFFFFF'. If you want to match on all nodes, set the dst-node parameter and the dst-mask parameter to X'000000000000'.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Default Value: X'000000000000'

dst-mask
Specifies the value to be ANDed with the destination node address (before being compared with the dst-address parameter). If you want to match on a single address, set the dst-address parameter to the address and set the dst-mask to X'FFFFFFFFFFFF'. If you want to match on all addresses, set the dst-address parameter and the dst-mask parameter to X'000000000000'.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Default Value: X'000000000000'

dst-sck-range-start
Specifies the start of a range (inclusive) of destination IPX sockets to be filtered. If you want to match on a single socket, set the dst-sck-range-start and dst-sck-range-end parameters to that socket. If you want to match on all sockets, set the dst-sck-range-start to X'0000' and the dst-sck-range-end to X'FFFF'.

Valid Values: X'0000' to X'FFFF'

Default Value: 0

dst-sck-range-end
Specifies the end of a range (inclusive) of destination IPX sockets to be filtered. If you want to match on a single socket, set the dst-sck-range-start and dst-sck-range-end parameters to that socket. If you want to match on all sockets, set the dst-sck-range-start to X'0000' and the dst-sck-range-end to X'FFFF'.

Valid Values: X'0000' to X'FFFF'

Default Value: 0

src-net-range-start
Specifies the start of a range (inclusive) of source IPX network numbers to be filtered. If you want to match on a single network number, set the src-net-range-start and src-net-range-end parameters to that network number. If you want to match on all network numbers, set the src-net-range-start to X'00000001' and the src-net-range-end to X'FFFFFFFE'.

Valid Values: X'00000000' to X'FFFFFFFE'

Default Value: X'00000000'

src-net-range-end
Specifies the end of a range (inclusive) of source IPX network numbers to be filtered. If you want to match on a single network number, set the src-net-range-start and src-net-range-end parameters to that network number. If you want to match on all network numbers, set the src-net-range-start to X'00000001' and the src-net-range-end to X'FFFFFFFE'.

Valid Values: X'00000000' to X'FFFFFFFE'

Default Value: X'00000000'

src-node
Specifies the value to be compared against the source node number (after being ANDed with the src-mask). If you want to match on a single node, set the src-node parameter to the node number and set the src-mask to X'FFFFFFFFFFFF'. If you want to match on all nodes, set the src-node parameter and the src-mask parameter to X'000000000000'.

Valid Values: X'00000000' to X'FFFFFFFF'

Default Value: X'00000000'

src-mask
Specifies the value to be ANDed with the source node address (before being compared with the src-address parameter). If you want to match on a single address, set the src-address parameter to the address and set the src-mask to X'FFFFFFFFFFFF'. If you want to match on all addresses, set the src-address parameter and the src-mask parameter to X'000000000000'.

Valid Values: X'000000000000' to X'FFFFFFFFFFFF'

Default Value: X'000000000000'

src-sck-range-start
Specifies the start of a range (inclusive) of source IPX sockets to be filtered. If you want to match on a single socket, set the src-sck-range-start and src-sck-range-end parameters to that socket. If you want to match on all sockets, set the src-sck-range-start to X'0000' and the src-sck-range-end to X'FFFF'.

Valid Values: X'0000' to X'FFFF'

Default Value: X'0000'

src-sck-range-end
Specifies the end of a range (inclusive) of source IPX sockets to be filtered. If you want to match on a single socket, set the src-sck-range-start and src-sck-range-end parameters to that socket. If you want to match on all sockets, set the src-sck-range-start to 0000 and the src-sck-range-end to FFFFF.

Valid Values: X'0000' to X'FFFF'

Default Value: X'0000'

Example:

add  <= 16  0  00000004 00000004 000000000000 000000000000
0000 FFFF 0000005A 0000006A 000000000000 000000000000 0000 FFFF

This example filters all packets from IPX networks 5A through 6A to IPX network 4.

Delete (Update Subcommand)

Use the delete subcommand to delete an item from the current filter-list.

Syntax:

delete
item#

item#
Specifies the number of the item in the list. The number can be obtained by using the list command to list the items in the filter-list.

Example: delete 4

List (Update Subcommand)

Use the list subcommand to display the filter-list action and list filter items.

Syntax:

list

Example: list

IPX IPX-List 'ipx01' Config>list
Action: EXCLUDE
Id   Hops Type Net Range           Address      Mask         Sock Range
---- ---- ---- ------------------- ------------ ------------ -----------
1    <=16    0     4320 -     4324 4000003A0002 FFFFFFFFFFFF    0 - FFFF (Dest)
                   3A33 -    13A33 400000010000 FFFFFFFF0000    0 - FFFF (Source)

Move (Update Subcommand)

Use the move subcommand change the order of filter items. After you change the order of filter items, they are renumbered to reflect the new order. The list command can be used to display a numbered list of configured filter items.

The src-line# parameter indicates the line to be moved. This line will be moved to precede the item specified by the dest-line# parameter.

Syntax:

move
src-line# dest-line#

Example: move 5 2

Set-action (Update Subcommand)

Use the set-action subcommand to indicate the action to be taken when a match is made to a filter-list

Syntax:

set-action
include
exclude

include
Specifies that if a match is found for the current filter, the packet will be processed (included) for ROUTER and IPX filters. For RIP and SAP filters, include specifies that the RIP or SAP entry will be processed.

Example: set-action include

exclude
Specifies that if a match is found for the current filter, the packet will be dropped (excluded) for ROUTER and IPX filters. For RIP and SAP filters, exclude specifies that if a match is found, the RIP or SAP entry will be ignored.

Example: set-action exclude


Accessing the IPX Monitoring Environment

For information on how to access the IPX monitoring environment, refer to "Getting Started (Introduction to the User circuit)" in the Access Integration Services Software User's Guide


IPX Monitoring Commands

Table 41 lists the IPX monitoring commands. The IPX monitoring commands allow you to view the parameters and statistics of the circuits and networks that transmit IPX packets. Monitoring commands display configuration values for the physical, frame, and packet levels. You also have the option of viewing the values for all three protocol levels at once.

Enter the IPX monitoring commands at the IPX> prompt. Table 41 summarizes the IPX monitoring commands.

Table 41. IPX Monitoring Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Access-controls   Displays whether the global IPX filter (access control) is enabled, the IPX access-control statements, and the number of packets that have matched each access-control statement. 
 Cache   Lists the current contents of the routing cache. 
 Counters   Displays the number of routing errors and packet overflows. 
 Delete keepalive connection   Deletes a Keepalive filtering table entry. 
 Disable   Disables IPX globally or on specific IPX circuits. 
 Dump routing tables   Displays the contents of the routing table. 
 Enable   Enables IPX globally or on specific IPX circuits. 
 Filters   Displays whether global SAP filtering is enabled, the SAP filter statements, and a count of the SAP advertisements which have been filtered. 
 Filter-Lists   Accesses the IPX circuit filter console. This is where the RIP router, RIP SAP, and IPX circuit-based filters can be monitored. 
 IPXWAN   Lists IPXWAN information for IPXWAN point-to-point circuits. 
 Keepalive   Displays the status of each active client/server connection in the keepalive-filtering table. 
 List   Lists the current configuration or the IPX address of each enabled circuit. 
 Ping   Sends IPXPING packets to another host and watches for a response. This command can be used to isolate trouble in an internetwork environment. 
Recordroute Sends IPXPING record route packets to another host and watches for a response. Use this command to record and display the round-trip route between this device and another host. Use this information to isolate trouble in an internetwork environment.
Reset Resets specific IPX circuits, global SAP filters, global IPX filters (access controls), static routes, static services, or the router, RIP, SAP, or IPX circuit-based filters (filter lists).
 Sizes   Displays the configured sizes of the local node and remote network caches, and the number of cache entries currently in use. 
 Slist   Displays the contents of the IPX SAP server table. 
Traceroute Sends IPXPING trace route packets to another host and watches for a response. Use this command to trace and display each hop a packet takes on its way from this device to a destination host. Use this information to isolate trouble in an internetwork environment.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Access Controls

Use the access-controls command to list the status of global IPX filters (access controls), the IPX access control statements, and a count of how many times each control statement has been followed.

Syntax:

access-controls

Example: access-controls

IPX Access Controls:  Enabled
#   T Dest Net Host         Sock Sock Src Net  Host         Sock  Sock Count
1   E 2        000000000000 0    FFFF 3        000000000000 0     FFFF 0
2   I 0        000000000000 452  453  0        000000000000 0     FFFF 0

#
Access control index number

Type
Identifies whether packets are sent or dropped for a specific address or set of addresses. I means include. This allows the packets to be sent. E means exclude. This causes the router to discard the packets.

Dest-net
Network number of the destination. Zero (0) means all networks.

Dest-host
Host number on the destination network (0) means all hosts on the network.

Dest-sck
Two numbers that specify an inclusive range of destination sockets.

Src-net
Network number of the source. Zero (0) means all networks.

Src-host
Host number on the source network. Zero means all hosts on the network.

Src-sck
Two numbers that specify an inclusive range of source sockets.

Count
Specifies the number of incoming IPX packets that have matched each access-control statement, causing the associated Type (Include or Exclude) to be performed.

Cache

Use the cache command to display the contents of the IPX routing cache.

Syntax:

cache

Example: cache

Dest Net/Node          Use Count      via Net/Node          Circ  Ifc
     420               1                  412/000004200000  3     2
     412               1                  412/000000000000  3     2
     412/000004200000  1                  412/000004200000  3     2

The first entry shows that the remote network 420 can be reached over the serial circuit with IPX network number 412. The second entry is the IPX network 412. It is an Ethernet directly attached to the router. This entry is a general local network entry. There will be one general local network entry for each of the directly attached networks after they have begun forwarding IPX packets. The last entry is a local entry on an Ethernet. This IPX cache entry has been used to send 1 packet to the IPX node number 0000 0420 0000 on net number 412.

Counters

Use the counters command to display the number of routing errors and packet overflows that have occurred. In the example, the counters show no recorded errors.

Syntax:

counters

Example: counters

Routing errors
Count  Type
0      Unknown
0      Checksum error
0      Destination unreachable
0      Hop count expired
0      circuit size exceeded
 
Destination errors
Count  Type
0      Unknown
0      Checksum error
0      Non-existent socket
0      Congestion
 
IPX input packet overflows
Circ   Ifc    Name        Count
1      0       Eth/0      0
2      1       PPP/0      0
3      2       PPP/1      0

Routing Errors

Unknown
An unspecified error occurred before reaching the destination.

Checksum
The checksum is incorrect, or the packet had some other serious inconsistency before reaching the destination.

Destination unreachable
The destination host cannot be reached from here.

Hop count expired
The packet has passed through 15 internet routers without reaching its destination.

circuit size exceeded
The packet is too large to be forwarded through some intermediate network.

Destination errors

Unknown
An unspecified error was detected at destination.

Checksum
The checksum is incorrect, or the packet has some other serious inconsistency detected at destination.

Nonexistent socket
The specified socket does not exist at the specified destination host.

Congestion
The destination cannot accept the packet due to resource limitations.

IPX Input Packet Overflows

Net
Specifies the circuit name.

Count
Specifies the number of packets that could not be received due to resource limitations.

Delete

Use the delete command to remove a Keepalive filtering table entry.

Syntax:

delete
entry#

entry#
Specifies the table entry to be deleted. The Keepalive command can be used to list the contents of the Keepalive filtering table.

Example: delete 1

Disable

Use the disable command to disable IPX globally or on specific circuits.

Syntax:

disable
circuit ...
ipx

circuit ipx-circuit#
Disables the IPX circuit specified by ipx-circuit#. IPX can be re-enabled using the enable command.

Example: disable circuit 2

ipx
Disables IPX globally on all IPX circuits. IPX can be globally re-enabled using the enable command.

Example: disable ipx

Dump

Use the dump command to display the contents of the routing tables.

Syntax:

dump

Example: dump

Type Dest Net Hops Delay Age(M: S)   via Router        Circ  Ifc
Dir  412      0    6        0: 0      412/000004000000 3     2
Dir  400      0    1        0: 0      400/020000000400 1     0
Dir  411      0    3        0: 0      411/400000000400 2     1
Stat 1        3    2        0: 0      400/010101010101 1     0
RIP  420      1    7        0:30      412/000004200000 3     2
Stat 444      2    2        0: 0      400/400000000444 1     0
Stat FFFFFFFD 14   3000     0: 0      400/111111111111 1     0

Type

Dest net
Specifies the destination network number.

Hops
Specifies the number of hops to this destination.

Delay
Specifies the estimate of how long it takes the router to transmit and for the packet to arrive at its destination. The unit of delay is the number of IBM PC clock ticks to send a 576-byte packet, which is 18.21 clock ticks per second. The minimum delay is 1 unit.

Age
Specifies the age of the routing information in minutes and seconds. If an entry in the routing table is not updated, the router takes the following actions:

Via router
Specifies the next hop for packets going to networks that are not directly connected. For directly connected networks, this is the address of the router circuit that transmits the packet.

Circ
IPX circuit number

Ifc
Network interface number

At the top of the display is the number of route and network entries used and the total available. If all the network entries are used, it is likely that the routing table is not large enough. Use the IPX configuration set maximum networks command to increase the size.

If all of the route entries are used, then there may be routes to IPX networks that cannot be kept, including new, incoming networks. If you do not want to increase the number of available routes, reduce the number of maximum routes per network.

Enable

Use the enable command to enable IPX globally or on specific circuits.

Syntax:

enable
circuit ...
ipx

circuit ipx-circuit#
Enables IPX on the circuit specified by ipx-circuit#. An IPX network number must have been configured for the circuit before IPX can be enabled.

Example: enable circuit 2

ipx
Globally enables IPX on all enabled IPX circuits.

Example: enable ipx

Filters

Use the filters command to display whether global SAP filtering is enabled, the SAP filter statements, and a count of the SAP advertisements that have been filtered.

Syntax:

filters

Example: filters

IPX SAP Filters:  Enabled
Count  Max Hops  Type  Service Name
0      5         4     FILESRV01

Count
Indicates the number of SAP advertisements that have been filtered (discarded).

Max Hops
Indicates the maximum number of hops permitted for the service.

Type
Is the numeric service class.

Service name
Is the name of the service if it has a name.

Filter-lists

Use the filter-lists command to access the IPX type-Lists> prompt. Valid types are: router-lists, rip-lists, sap-lists, and ipx-lists.

For information about the commands available from this prompt, see "IPX Circuit Filter Monitoring Commands".

Syntax:

filter-lists
router-lists
rip-lists
sap-lists
ipx-lists

Example: filter-lists router-lists

IPXWAN

Use the ipxwan command to list the IPXWAN information for IPXWAN point-to-point circuits.

Syntax:

ipxwan
detailed . . .
summary

detailed ipx-circuit#
Lists the IPXWAN information for the IPX circuit specified.

Example: ipxwan detailed 3

Detailed information for IPXWAN link over circuit 3 interface 2, PPP/1
This side is the IPXWAN slave
Neighbor Name: ipxwan-420
Neighbor Node ID: 420
Negotiated Routing Type: RIP/SAP
Link Delay: 6 1/18th sec ticks
Common Net#: 412
Connection Timeouts: 0
Connection Retries: 0
Timer Requests Sent: 1
Timer Requests Received: 1
Timer Responses Sent: 1
Timer Responses Received: 0
Info Requests Sent: 0
Info Requests Received: 1
Info Responses Sent: 1
Info Responses Received: 0

Neighbor Name
The router name of the neighbor as received in the RIP/SAP Information Request Packet.

Neighbor Node ID
The node ID (also known as the primary network number) of the neighbor. This is a IPX network number unique to the entire internetwork. It is a 32-bit quantity.

Negotiated Routing Type
The negotiated routing type. Currently supported are RIP/SAP, unnumbered RIP, and Static Routing. When either unnumbered RIP or static routing is the negotiated routing type, no common network number is required on the link.

Link Delay
The link delay in 1/18th second ticks calculated by the master. It is a 16-bit quantity. It is always calculated, therefore there is no default.

Common Net#
The network number agreed upon by both ends of the link. This number must be unique to the entire internetwork. It is a 32-bit quantity. When the negotiated routing type is either unnumbered RIP or Static Routing, the value 0 will be displayed as the Common Net# for both the IPXWAN detailed and IPXWAN summary commands. There is no default, it must be negotiated.

Connection Timeouts
The number of times the connection timed out. A connection will timeout periodically if the exchange of IPXWAN packets does not proceed. You can configure the timeout period using the set ipxwan command. The default for the timeout period is 60 seconds.

Connection Retries
The number of times the connection is retried after timing out. The amount of time to wait (before retrying) is configurable by using the set ipxwan command. It defaults to 60 seconds.

Timer Requests Sent
The number of IPXWAN Timer Request packets sent.

Timer Requests Received
The number of IPXWAN Timer Request packets received.

Timer Responses Sent
The number of IPXWAN Timer Response packets sent.

Timer Responses Received
The number of IPXWAN Timer Response packets received.

Info Requests Sent
The number of IPXWAN Information Request packets sent.

Info Requests Received
The number of IPXWAN Information Request packets received.

Info Responses Sent
The number of IPXWAN Information Response packets sent.

Info Responses Received
The number of IPXWAN Information Response packets received.

summary
Lists IPXWAN summary information for all IPXWAN point-to-point circuits.

Example: ipxwan summary

Circ   Ifc    Name        Common Net#  NodeID   Neighbor Name
3      2       PPP/1      412          420      ipxwan-420

Circ
IPX circuit number

Ifc
Network interface number

Common Net#
Network number agreed upon by both ends of the link. This number must be unique to the entire internetwork. The common net# will be 0 if the negotiated routing type is either unnumbered RIP or Static Routing.

NodeID
Node ID (also known as the internal network number) of the neighbor.

Neighbor Name
Router name of the neighbor as received in the RIP/SAP Information Request Packet.

Keepalive

Shows the status of each active client/server connection in the keepalive-filtering table.

Syntax:

keepalive

Example:

Keepalive
Conn #     Net  /   Node     /Sock        Net  /   Node     /Sock
          -----------------------------------------------------------------
0         272727/000000000001/4001         302/0000C911EF1C/4004
                (server conn # 1, conn type: passive, last heard  1:00 ago)
1         272727/000000000001/4001         302/0000C911B0D9/4004
                (server conn # 2, conn type: passive, last heard  1:00 ago)

List

Use the list command to list the current configuration or the IPX address of each enabled IPX circuit.

Syntax:

list
addresses
configuration

addresses
Lists the IPX address of each enabled IPX circuit.

Example:

Circ   Ifc    Name        Type                             Network/Address
1      0       Eth/0      Ethernet                         400/020000000400
2      1       PPP/0      SCC Serial Line                  411/400000000400
3      2       FR/0       FR PVC                           412/000004000000
        Frame Relay PVC circuit number: 16 
4      3       FR/0       FR SVC                           413/000004000000
        Frame Relay SVC circuit name: Indianapolis  
 

Configuration
List the current IPX configuration. This command displays the same information as the list summary configuration command. See List for an example of the display and an explanation of the output.

Ping

Use the ping command to make the router send IPXPING packets to a given destination ("pinging") and watch for a response. This command can be used to isolate trouble in an internetwork environment.

This process is done continuously. Matching received responses are displayed with the sender's IPX network number and node number, the number of hops, and the round-trip time in milliseconds.

To stop the pinging process, type any character at the monitoring. At that time, a summary of packet loss, round-trip time, and number of unreachable destinations will be displayed.

When a multicast address is given as destination, there may be multiple responses for each packet sent, one for each group member. Each returned response is displayed with the source address of the responder.

Notes:

  1. Care should be taken when specifying the broadcast address (FFFFFFFFFFFF), as this could generate a large number of IPXPING response packets, which would degrade network and routing software performance.

  2. If you enter the ping command without any parameters, you will be prompted for all parameters. If you enter only destination network and destination node, default values will be used for the remaining parameters.

Syntax:

ping
dest-net dest-node src-net src-node size rate

dest-net
Specifies the destination IPX network number. This parameter is required.

Valid Values: X'1' to X'FFFFFFFD'

Default Value: 1

dest-node
Specifies the destination IPX node address. This parameter is required.

Valid Value: X'1' to X'FFFFFFFFFFFF'

Default Value: None

src-net
Specifies the source IPX network number. This is an optional parameter. The value must be a known network number that is associated with a direct attached IPX circuit. If a source network is not specified, the network number of the IPX circuit on which the IPXPING request packets are sent will be used as the source IPX node. If the IPX circuit is an IPXWAN unnumbered RIP or static routing circuit, the node address of the IPX circuit used for the source network number will be used as the source node.

Valid Value: X'1' - X'FFFFFFFD'

Default Value: 1

src-node
Specifies the source IPX node address. This is an optional parameter. The value must be a known node address that is associated with a direct attached IPX circuit. If a source node is not specified, the node address of the IPX circuit on which the IPXPING request packets are sent will be used as the source IPX node. If the IPX circuit is an IPXWAN unnumbered RIP or static routing circuit,, the node address of the IPX circuit used for the source network number will be used as the source node.

Valid Value: X'1' - X'FFFFFFFFFFFE'

Default Value: None

size
Specifies the number of data bytes to be appended to the ping request. This is an optional parameter. The data includes the time the request is first sent so the amount specified cannot be smaller than 4 bytes. It also cannot be larger than the maximum packet size supported by the router or the output circuit. This value can vary depending on the configuration.

Valid Value: 4 to Router Maximum

Default Value: 56 bytes

rate
Specifies the number of seconds between ping requests. This is an optional parameter.

Valid Value: 1 to 60

Default Value: 1

Example: ping

Destination network number [1]? 20
Destination node number []? 00000001c200
Source network number [1]? 10
Source node number []? 000000019a00
Data size: [56]?
Rate in seconds [1]?
 
IPXPING 20/00000001C200: 56 data bytes
56 data bytes from 20/00000001C200: hops=3 time=0 ms
56 data bytes from 20/00000001C200: hops=3 time=40 ms
56 data bytes from 20/00000001C200: hops=3 time=0 ms
 
----20/00000001C200 IPXPING Statistics----
3 packets transmitted, 3 packets received, 0% packet loss
round-trip (ms) min/ave/max = 0/13/40  

RecordRoute

Use the recordroute command to report every forwarding circuit on the path to the destination and back again. If recordroute is invoked with no parameters, you will be prompted for all of them. Only the destination IPX network number and destination IPX node address are required.

There are two events that will end a recordroute. The first is when you press a key. The second is when the maximum number of recordroute request packets have been sent.

Syntax:

recordroute
dest-net dest-node src-net src-node rate number

dest-net
Specifies the destination IPX network number. This parameter is required.

Valid Values: X'1' to X'FFFFFFFD'

Default Value: 1

dest-node
Specifies the destination IPX node address. This parameter is required.

Valid Values: X'1' to X'FFFFFFFFFFFE'

Default Value: None

src-net
Specifies the source IPX network number. This is an optional parameter. The value must be a known network number that is associated with a direct attached IPX circuit. If a source network is not specified, the network number of the IPX circuit on which the recordroute packets are sent will be used as the source IPX address. If the IPX circuit is an IPXWAN unnumbered RIP or static routing circuit, the network number of some other numbered IPX circuit will be used as the source address, since IPXWAN unnumbered RIP and static routing circuits are not assigned an IPX network number.

Valid Values: X'1' to X'FFFFFFFD'

Default Value: 1

src-node
Specifies the source IPX node address. This is an optional parameter. The value must be a known node address that is associated with a direct attached IPX circuit. If a source node is not specified, the node address of the IPX circuit on which the recordroute packets are sent will be used as the source IPX node. If the IPX circuit is an IPXWAN unnumbered RIP or static routing circuit, the node address of IPX circuit used for the source network number will be used as the source node.

Valid Values: X'1' to X'FFFFFFFFFFFE'

Default Value: None

rate
Specifies the number of seconds between recordroute requests. This is an optional parameter.

Valid Values: 1 to 60

Default Value: 1

number
Specifies the maximum number of recordroute requests to be sent. This is an optional parameter. A value of zero will cause the recordroute to continue until a key is pressed.

Valid Values: 0 to 60

Default Value: 0

Example: recordroute

Destination network number [1]? 20
Destination node number []? 00000001c200
Source network number [1]? 10
Source node number []? 000000019a00
Rate in seconds [1]?
Number of packets to send [0]?
 
RECORDROUTE 20/00000001C200: 784 data bytes
784 data bytes from 20/00000001C200: seq_no=0 time=0 ms
Recorded Routes (in hex):
                10/000000019A00
                500/0000100A0000
                500/0000100C0000
                10/000000019000
                10/000000019A00 (Final Destination)
 
784 data bytes from 20/00000001C200: seq_no=1 time=30 ms  (same route)
784 data bytes from 20/00000001C200: seq_no=2 time=10 ms  (same route)
...
784 data bytes from 20/00000001C200: seq_no=18 time=0 ms
Recorded Routes (in hex):
                10/000000019A00
                0/0000100A0000
                20/00000001AE00
                20/00000001C200
                0/0000100B0000
                10/000000019000
                10/000000019A00 (Final Destination)
 
784 data bytes from 20/00000001C200: seq_no=19 time=0 ms  (same route)
784 data bytes from 20/00000001C200: seq_no=20 time=70 ms  (same route)
784 data bytes from 20/00000001C200: seq_no=21 time=0 ms  (same route)
...
784 data bytes from 20/00000001C200: seq_no=48 time=0 ms
Recorded Routes (in hex):
                10/000000019A00
                500/0000100A0000
                500/0000100C0000
                10/000000019000
                10/000000019A00 (Final Destination)
 
784 data bytes from 20/00000001C200: seq_no=49 time=0 ms  (same route)
784 data bytes from 20/00000001C200: seq_no=50 time=0 ms  (same route)
 
----20/00000001C200 RECORDROUTE Statistics----
53 packets transmitted, 38 packets received, 28% packet loss
5 unreachables, 0 no usable source addresses, 0 buffer unavailable
round-trip (ms) min/ave/max = 0/23/100            

The entire path is reported only once on the first response or when the path changed. In the above example, the path changed twice.

Reset

Use the reset command to reset specific IPX circuits, global SAP filters, global IPX filters (access controls), static routes, static services, or the Router, RIP, SAP, or IPX circuit-based filters (filter lists).

Syntax:

reset
access-controls
circuit . . .
filters
filter-lists
route-static
sap-static

access-controls
Resets the global IPX filters (access-controls) based on the configuration parameter stored in the configuration memory. Changes made to the global IPX filter configuration will be activated.

Example: reset access-controls

circuit ipx-circuit#
Resets IPX on the specified IPX circuit using configuration parameter values stored in the configuration memory. Changes made to the IPX configuration on the IPX circuit will be activated.

Example: reset circuit 2

filters
Resets the global SAP filters based on the configuration parameter values stored in the configuration memory. Changes made to the global SAP filter configuration will be activated.

Example: reset filters

filter-lists filter-type
Resets the circuit-based filter based on configuration parameter values stored in the configuration memory. Changes made to the circuit-based filter configuration will be activated. Valid filter-types are router,rip,sap, and ipx.

Example: reset filter-lists rip

route-static
Resets the static routes based on the configuration parameter values stored in the configuration memory. Changes made to the static route configuration will be activated.

Example: reset route-static

sap-static
Resets the static services based on the configuration parameter values stored in the configuration memory. Changes made to the static services configuration will be activated.

Example: reset sap static

Sizes

Use the sizes command to display the configured sizes of the local node and remote network caches, and the number of cache entries currently in use. (This command does not display the contents of the caches.)

Syntax:

sizes

Example: sizes

Current IPX cache size:
Remote network cache size (max entries): 64
       2 entries now in use
 
Local node cache size (max entries): 128
       1 entries now in use

Slist

Use the slist command to display the contents of the IPX SAP server table.

Syntax:

slist

Example: slist

9 entries used out of 32
 
State Typ Service Name                  Hops   Age     Net  /   Host     /Sock
SAP  4    PCS12                          3     0:50        1/000000000048/0451
SAP  4    ACMPCS                         3     0:50        1/00000000004A/0451
SAP  4    DEVEL2                         1     0:50       11/0000000000B4/0451
SAP  4    PLANNING                       2     0:50       BB/0000000000B7/0451
SAP  4    DEVEL                          2     0:50       BB/0000000000EE/0451
SAP  4    SOFT2                          1     0:30      704/000000000094/0451
SAP  4    SKYSURF1                       2     0: 5 2C39ABE9/000000000001/0451
SAP  278  DIRTREE                        2     0: 5 2C29ABE9/000000000001/4005
Stat 26B  DIRTREE                        2     0: 0      444/000000000001/0045

State
Specifies one of the following parameters:
SAP - indicates that this service was obtained by the SAP routing protocol.
Del - indicates that this service has timed out and is no longer being used. The service is kept briefly in the table to inform other routers that the service is no longer valid. After that, it is deleted and is no longer displayed.
Stat - indicates that this service is a static service.

Typ
Specifies the server type in hexadecimal. File servers are type 0004. Other type numbers are assigned by Novell.

Service name
Specifies the server's unique name for this type of server. Only the first 30 characters of the 47-character name are displayed to conserve space.

Hops
Specifies the number of router hops from this router to the server.

Age
Specifies the age of the service information. If an entry in the SAP table is not updated, the router takes the following actions:

Net/Host/Sock
Specifies the address of the service. The address includes the following parameters:

At the bottom of the display is the number of entries used and the total available. If all the entries are used, it is likely that the service table is not large enough. Use the IPX configuration set maximum services command to increase the size.

Traceroute

Use the traceroute command to report each hop a ping request takes on its way to a final destination. If traceroute is invoked with no parameters, you will be prompted for all of them. Only the destination IPX network number and destination IPX node address are required.

There are three events that will end a traceroute. The first is when you press a key. The second is when a response is received from the destination address. The third is when the maximum number of hops has been reached.

Syntax:

traceroute
dest-net dest-node src-net src-node size probes rate hops

dest-net
Specifies the destination IPX network number. This parameter is required.

Valid Values: X'1' to X'FFFFFFFD'

Default Value: 1

dest-node
Specifies the destination IPX node address. This parameter is required.

Valid Values: X'1' to X'FFFFFFFFFFFE'

Default Value: None

src-net
Specifies the source IPX network number. This is an optional parameter. The value must be a known network number that is associated with a direct attached IPX circuit. If a source network is not specified, the network number of the IPX circuit on which the traceroute packets are sent will be used as the source IPX address. If the IPX circuit is an IPXWAN unnumbered RIP or static routing circuit, the network number of some other numbered IPX circuit will be used as the source address, since IPXWAN unnumbered RIP and static routing circuits are not assigned an IPX network number.

Valid Value: X'1' to X'FFFFFFFD'

Default Value: 1

src-node
Specifies the source IPX node address. This is an optional parameter. The value must be a known node address that is associated with a direct attached IPX circuit. If a source node is not specified, the node address of the IPX circuit on which the traceroute packets are sent will be used as the source IPX node. If the IPX circuit is an IPXWAN unnumbered RIP or static routing circuit, the node address of IPX circuit used for the source network number will be used as the source node.

Valid Values:X'1' to X'FFFFFFFFFFFE'

Default Value: None

size
Specifies the number of data bytes to be appended to the traceroute request. This is an optional parameter. The data includes the time the request is first sent, so the number specified cannot be smaller than 4 bytes. It also cannot be larger than the maximum packet size of the router or the output circuit. This value can vary depending on the configuration.

Valid Values: 4 to router maximum

Default Value: 56

probes
Specifies how many traceroute requests to send per hop. This is an optional parameter.

Valid Values: 1 to 10

Default Value: 3

rate
Specifies the number of seconds to wait between probes, when there is not an answer to the traceroute request. This is an optional parameter.

Valid Values: 1 to 60

Default Value: 1

hops
Specifies the maximum number of hops to send traceroute requests. This is an optional parameter. Without NLSP, a packet can traverse a maximum of 16 nodes (hence the default of 16). With NLSP or the IBM 6611 half-router solution, the limit is no longer 16.

Valid Values: 1 to 255

Default Value: 16

Example: traceroute

Destination network number [1]? 20
Destination node number []? 00000001c200
Source network number [1]? 10
Source node number []? 000000019a00
Data size:  [56]?
Number of probes per hop [3]?
Wait time between retries in seconds [1]?
Maximum Hops [16]?
 
TRACEROUTE 20/00000001C200: 56 data bytes
1 10/000000019000: 0 ms * 500/0000100B0000 20 ms
2 * * *
3 20/00000001C200: 10 ms 60 ms 20 ms

The source IPX address of a traceroute response is reported only once as long as it does not change. In the above example, two different routers responded to the one hop traceroute request. This would happen if the route to the destination changed between probes.

There is other information reported by traceroute besides the round trip time of a probe:


IPX Circuit Filter Monitoring Commands

Table 42 lists the commands available from the IPX type-Lists> prompt. Each of these commands is explained in detail in this section.

To access the IPX type-Lists> prompt, enter filter-lists type at the IPX> prompt. Valid types are router-lists, rip-lists, sap-lists, and ipx-lists.

Table 42. IPX circuit Filter Command Summary
 Command   Function 
 Cache   Displays the contents of the filter cache for the specified circuit. Only the IPX filter supports a filter cache. 
 Clear   Clears the counters of the specified filter, or clears the counters of all filters of the current type (ROUTER, RIP, SAP, or IPX). 
 Disable   Disables a specified filter, or all filters of the current type. 
 Enable   Enables a specified filter, or all filters of the current type. 
 List   Lists a specified filter, or all filters of the current type. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Cache

Use the cache command to display the contents of the filter cache. Only the IPX filter supports a cache. ROUTER, RIP, and SAP filters do not support a filter cache.

Syntax:

cache filter
filter#

filter#
Specifies the number of the filter. The list command can be used to display a numbered list of configured filters.

Example: cache filter 1

IPX IPX-Lists>cache filter 1
Hops Type Dst Net  Address      Sock Src Net  Address      Sock Action
---- ---- -------- ------------ ---- -------- ------------ ---- -------
   4   00 04000000 400003900000  802 03000040 400003004400  966 EXCLUDE
   2   00 0004A300 400000233D00  952 0763A020 4000000DD100  920 INCLUDE

Clear

Use the clear command to clear the counters of the specified filter, or to clear the counters of all filters of the current type (ROUTER, RIP, SAP, or IPX).

Syntax:

clear
all
filter ...

all
Clears the counters of all filters of the current type (ROUTER, RIP, SAP, or IPX).

Example: clear all

filter filter#
Clears the counters of the specified filter number. The list command can be used to display a numbered list of configured filters.

Example: clear filter 1

Disable

Use the disable command to disable specific filters or to disable all filters of the current type (ROUTER, RIP, SAP, or IPX).

Syntax:

disable
all
filter filter#

all
Disables all filters of the current type (ROUTER, RIP, SAP, or IPX).

Example: disable all

filter filter#
Disables the specified filter number. The list command can be used to display a numbered list of configured filters.

Example: disable filter 1

Enable

Use the enable command to enable specific filters or to enable all filters of the current type (ROUTER, RIP, SAP, or IPX).

Syntax:

enable
all
filter filter#

all
Enables all filters of the current type (ROUTER, RIP, SAP, or IPX).

Example: enable all

filter filter#
Enables the specified filter number. The list command can be used to display a numbered list of configured filters.

Example: enable filter 1

List

Use the list command to display information about specific filters, or about all filters of the current type (ROUTER, RIP, SAP, or IPX).

Syntax:

list
all
filter filter#

all
Lists the configuration of all filters of the current type (ROUTER, RIP, SAP, or IPX).

Example: list all

IPX IPX-Lists>list all
Filtering: ENABLED
 
Filter Lists:
Name                           Action
------------------------------ ----------
ipx01                          EXCLUDE
ipx02                          INCLUDE
ipx03                          EXCLUDE
 
Filters:                                                      
Id    Circ  Ifc   Direction  State      Default    Cache      
----- ----- ----- ---------- ---------- ---------- -----      
1     1     0     INPUT      ENABLED    INCLUDE    10         
2     1     0     OUTPUT     ENABLED    INCLUDE    10         
3     2     1     INPUT      DISABLED   INCLUDE    10         
4     2     1     OUTPUT     DISABLED   INCLUDE    10         
                                                                
 

filter filter#
Lists the configuration of the specified filter number. The list command can be used to display a numbered list of configured filters.

Example: list filter 1

IPX IPX-Lists>list filter 1
 
Filters:                                                     
Id    Circ  Ifc   Direction  State      Default    Cache     
----- ----- ----- ---------- ---------- ---------- -----     
1     1     0     INPUT      ENABLED    INCLUDE    10        
 
Filter Lists:
Name                           Action     Count
------------------------------ ---------- ----------
ipx01                          EXCLUDE    43
ipx02                          INCLUDE    23453

IPX Dynamic Reconfiguration Support

This section describes dynamic reconfiguration (DR) as it affects Talk 6 and Talk 5 commands.

CONFIG (Talk 6) Delete Interface

Internet Packet Exchange (IPX) supports the CONFIG (Talk 6) delete interface command with the following consideration:

When the network interface is deleted, all IPX circuits, static routes, static services and circuit-filters (RIP router, RIP, SAP and IPX) configured on the network interface are deleted from the configuration memory.

GWCON (Talk 5) Activate Interface

IPX supports the GWCON (Talk 5) activate interface command with the following considerations:

The following table summarizes the IPX configuration changes that are activated when the GWCON (Talk 5) activate interface command is invoked:
Commands performed as part of the GWCON (Talk 5) activate interface command
GWCON, protocol IPX, reset circuit
Note:When the network interface is activated, all IPX circuits configured on the network interface are activated.

GWCON (Talk 5) Reset Interface

IPX supports the GWCON (Talk 5) reset interface command with the following considerations:

The following table summarizes the IPX configuration changes that are activated when the GWCON (Talk 5) reset interface command is invoked:
Commands performed as part of the GWCON (Talk 5) reset interface command
GWCON, protocol IPX, reset circuit
Note:When the network interface is reset, all IPX circuits configured on the network interface are reset.

GWCON (Talk 5) Component Reset Commands

IPX supports the following IPX-specific GWCON (Talk 5) reset commands:

GWCON, Protocol IPX, Reset Circuit Command

Description:
The specified IPX circuit is reset.

Network Effect:
The IPX circuit is deleted and recreated using the IPX circuit parameters in the configuration memory. All routes and services learned through the IPX circuit are advertised as down, are deleted, and then re-learned when the IPX circuit is recreated. If the IPX network number on the circuit has changed, sessions involving the clients on that circuit will be lost and the clients may have to be reset.

Limitations:

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset circuit command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset circuit command
CONFIG, protocol IPX, add broadcast-circuit
CONFIG, protocol IPX, add ipxwan-circuit
CONFIG, protocol IPX, delete circuit
CONFIG, protocol IPX, disable circuit
CONFIG, protocol IPX, disable keepalive-filtering
CONFIG, protocol IPX, disable netbios-broadcast
CONFIG, protocol IPX, disable reply-to-get-nearest serve
CONFIG, protocol IPX, disable rip
CONFIG, protocol IPX, disable rip-sap-pacing
CONFIG, protocol IPX, disable sap
CONFIG, protocol IPX, enable circuit
CONFIG, protocol IPX, enable keepalive-filtering
CONFIG, protocol IPX, enable netbios-broadcast
CONFIG, protocol IPX, enable reply-to-get-nearest serve
CONFIG, protocol IPX, enable rip
CONFIG, protocol IPX, enable rip-sap-pacing
CONFIG, protocol IPX, enable sap
CONFIG, protocol IPX, frame
CONFIG, protocol IPX, move circuit
CONFIG, protocol IPX, set ipxwan
CONFIG, protocol IPX, set net-number
CONFIG, protocol IPX, set rip-ticks
CONFIG, protocol IPX, set rip-update-interval
CONFIG, protocol IPX, set sap-update-interval
CONFIG, protocol IPX, set split-horizon

GWCON, Protocol IPX, Reset Route-Static Command

Description:
All IPX static routes, including the default route, and whether IPX static routing is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset route-static command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset route-static command
CONFIG, protocol IPX, add route-static
CONFIG, protocol IPX, delete route-static
CONFIG, protocol IPX, disable route-static
CONFIG, protocol IPX, enable route-static

GWCON, Protocol IPX, Reset Sap-Static Command

Description:
All IPX static services, including whether the use of IPX static services is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset sap-static command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset sap-static command
CONFIG, protocol IPX, add sap-static
CONFIG, protocol IPX, delete sap-static
CONFIG, protocol IPX, disable sap-static
CONFIG, protocol IPX, enable sap-static

GWCON, Protocol IPX, Reset Filters Command

Description:
All global SAP filters, including whether the use of SAP filtering is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset filters command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset filters command
CONFIG, protocol IPX, add filter
CONFIG, protocol IPX, delete filter
CONFIG, protocol IPX, set filter

GWCON, Protocol IPX, Reset Access-Controls Command

Description:
All global IPX filters (access-controls), including whether the use of IPX filtering is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset access-controls command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset access-controls command
CONFIG, protocol IPX, add access-control
CONFIG, protocol IPX, delete access-control
CONFIG, protocol IPX, move access-control
CONFIG, protocol IPX, set access-control

GWCON, Protocol IPX, Reset Filter-Lists Router Command

Description:
All RIP router circuit filters, filter-lists and items, including whether the use of RIP router circuit filters is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset filter-lists router command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset filter-lists router command
CONFIG, protocol IPX, filter-lists router, attach
CONFIG, protocol IPX, filter-lists router, create
CONFIG, protocol IPX, filter-lists router, default
CONFIG, protocol IPX, filter-lists router, delete
CONFIG, protocol IPX, filter-lists router, detach
CONFIG, protocol IPX, filter-lists router, disable
CONFIG, protocol IPX, filter-lists router, enable
CONFIG, protocol IPX, filter-lists router, move
CONFIG, protocol IPX, filter-lists router, update, add
CONFIG, protocol IPX, filter-lists router, update, delete
CONFIG, protocol IPX, filter-lists router, update, move
CONFIG, protocol IPX, filter-lists router, update, set-action

GWCON, Protocol IPX, Reset Filter-Lists RIP Command

Description:
All RIP circuit filters, filter-lists and items, including whether the use of RIP circuit filters is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset filter-lists rip command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset filter-lists rip command
CONFIG, protocol IPX, filter-lists rip, attach
CONFIG, protocol IPX, filter-lists rip, create
CONFIG, protocol IPX, filter-lists rip, default
CONFIG, protocol IPX, filter-lists rip, delete
CONFIG, protocol IPX, filter-lists rip, detach
CONFIG, protocol IPX, filter-lists rip, disable
CONFIG, protocol IPX, filter-lists rip, enable
CONFIG, protocol IPX, filter-lists rip, move
CONFIG, protocol IPX, filter-lists rip, update, add
CONFIG, protocol IPX, filter-lists rip, update, delete
CONFIG, protocol IPX, filter-lists rip, update, move
CONFIG, protocol IPX, filter-lists rip, update, set-action

GWCON, Protocol IPX, Reset Filter-Lists SAP Command

Description:
All SAP circuit filters, filter-lists and items, including whether the use of SAP circuit filters is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset filter-lists sap command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset filter-lists sap command
CONFIG, protocol IPX, filter-lists sap, attach
CONFIG, protocol IPX, filter-lists sap, create
CONFIG, protocol IPX, filter-lists sap, default
CONFIG, protocol IPX, filter-lists sap, delete
CONFIG, protocol IPX, filter-lists sap, detach
CONFIG, protocol IPX, filter-lists sap, disable
CONFIG, protocol IPX, filter-lists sap, enable
CONFIG, protocol IPX, filter-lists sap, move
CONFIG, protocol IPX, filter-lists sap, update, add
CONFIG, protocol IPX, filter-lists sap, update, delete
CONFIG, protocol IPX, filter-lists sap, update, move
CONFIG, protocol IPX, filter-lists sap, update, set-action

GWCON, Protocol IPX, Reset Filter-Lists IPX Command

Description:
All IPX circuit filters, filter-lists and items, including whether the use of IPX circuit filters is globally enabled or disabled, are reset.

Network Effect:
No network disruption.

Limitations:
None.

The following table summarizes the IPX configuration changes that are activated when the GWCON, protocol IPX, reset filter-lists ipx command is invoked:
Commands whose changes are activated by the GWCON, protocol IPX, reset filter-lists ipx command
CONFIG, protocol IPX, filter-lists ipx, attach
CONFIG, protocol IPX, filter-lists ipx, create
CONFIG, protocol IPX, filter-lists ipx, default
CONFIG, protocol IPX, filter-lists ipx, delete
CONFIG, protocol IPX, filter-lists ipx, detach
CONFIG, protocol IPX, filter-lists ipx, disable
CONFIG, protocol IPX, filter-lists ipx, enable
CONFIG, protocol IPX, filter-lists ipx, move
CONFIG, protocol IPX, filter-lists ipx, set-cache
CONFIG, protocol IPX, filter-lists ipx, update, add
CONFIG, protocol IPX, filter-lists ipx, update, delete
CONFIG, protocol IPX, filter-lists ipx, update, move
CONFIG, protocol IPX, filter-lists ipx, update, set-action

GWCON (Talk 5) Temporary Change Commands

IPX supports the following GWCON commands that temporarily change the operational state of the device. These changes are lost whenever the device is reloaded, restarted, or you execute any dynamically reconfigurable command.
Commands
GWCON, protocol IPX, disable circuit
GWCON, protocol IPX, disable ipx
GWCON, protocol IPX, enable circuit
GWCON, protocol IPX, enable ipx

Non-Dynamically Reconfigurable Commands

The following table describes the IPX configuration commands that cannot be dynamically changed. To activate these commands, you need to reload or restart the device.
Commands
CONFIG, protocol IPX, set keepalive-table-size
CONFIG, protocol IPX, set local-cache size
CONFIG, protocol IPX, set maximum networks
CONFIG, protocol IPX, set maximum routes-per-destination
CONFIG, protocol IPX, set maximum services
CONFIG, protocol IPX, set maximum total-route-entries
CONFIG, protocol IPX, set name
CONFIG, protocol IPX, set node-id
CONFIG, protocol IPX, set remote-cache size


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]